/**
 * @(#)PropiedadesManagerK.java Feb 4, 2007
 *
 * Copyright (c) 2005-2010 Psiqueware S.A. de C.V. All Rights Reserved.
 * This software is the proprietary information Psiqueware S.A. de C.V.
 * Use is subject to license terms.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *
 * <br/>Usuario : AngelElectrico
 * <br/>Creaci&oacute;n: Feb 4, 2007 - 10:56:37 AM
 * <br/>
 * <br/>
 * <br/><t5>Cambios :</t5>
 * <br/><b>Fecha | Autor  |  Cambios</b>
 * <ul>
 * <li>Feb 4, 2007 | <a href = "mailto:AngelElectrico@PsiqueWare.com">Angel El&eacute;ctrico</a> | Creaci&oacute;n del Objeto.</li>
 *
 * </ul>
 */

package com.psiqueware.alheli.seguridad.manager;

import com.psiqueware.alheli.dao.EnlaceTransaccional;
import com.psiqueware.alheli.exception.NullArgumentException;
import com.psiqueware.alheli.logging.Logger;
import com.psiqueware.alheli.logging.LoggerFactory;
import com.psiqueware.alheli.manager.BaseManager;
import com.psiqueware.alheli.manager.ManagerException;
import com.psiqueware.alheli.seguridad.Agrupacion;
import com.psiqueware.alheli.seguridad.Propiedad;
import com.psiqueware.alheli.seguridad.PropiedadTienePropietarioException;
import com.psiqueware.alheli.seguridad.PropiedadesManager;
import com.psiqueware.alheli.seguridad.Titulo;
import com.psiqueware.alheli.seguridad.UsuarioSeguridad;
import com.psiqueware.alheli.seguridad.dao.SeguridadDAOFactory;
import com.psiqueware.alheli.seguridad.modelo.TituloK;

/**
 * Encargado de las operaciones relacionadas con las {@link Propiedad}es.
 * <br/>Paquete Original: com.psiqueware.basico.seguridad.manager
 * <br/>Nombre  Original: RegistroPropiedadTManagerK
 * <br/>Oprima para ver : <a href="PropiedadesManagerK.java.html"><i>C&oacute;digo Fuente</i> </a>
 *
 * @author <a href="mailto:AngelElectrico@PsiqueWare.com">Angel El&eacute;ctrico</a>
 * @version Revision: 1.1 Feb 4, 2007 10:56:37 AM
 * @noinspection DuplicateStringLiteralInspection, ClassWithoutToString
 */
public final class PropiedadesManagerK extends BaseManager implements PropiedadesManager
{

    /**
     * Logger de clase para PropiedadesManagerK
     */
    private static final Logger s_log = LoggerFactory.getLogger(PropiedadesManagerK.class);

    /**
     * Constructor de PropiedadesManagerK.
     */
    public PropiedadesManagerK()
    {
    }

    /**
     * Obtiene el {@link Titulo} de esta {@link Propiedad}.
     *
     * @param propiedad           que se pretende apropiar.
     * @param propietario         {@link UsuarioSeguridad} que quiere apropiarse de la {@link Propiedad}.
     * @param enlaceTransaccional para hacer atomica la transaccion.
     * @param clave               para facilitar la identificacion de la {@link Propiedad}.
     *
     * @return {@link Titulo} de la {@link Propiedad}.
     *
     * @throws com.psiqueware.alheli.manager.ManagerException
     *          en caso de que
     * @noinspection DuplicateStringLiteralInspection
     */
    public Titulo apropiar(Propiedad propiedad, UsuarioSeguridad propietario, String clave, final EnlaceTransaccional enlaceTransaccional) throws ManagerException
    {
        try
        {
            //Validamos
            if (null == propiedad)
                throw new NullArgumentException("<error>El argumento 'propiedad' no puede ser NULL.</error>");
            if (null == propiedad.getId())
                throw new IllegalArgumentException("<error>El argumento 'propiedad' deb&iacute;a encontrarse previamente persistido.</error>");
            if (null == propietario.getCredencial())
                throw new NullArgumentException("<error>UsuarioSeguridad no ha sido registrado.</error>");
            if (tienePropietario(propiedad, enlaceTransaccional)) throw new PropiedadTienePropietarioException();

            TituloK tituloK = new TituloK(propiedad, propietario.getCredencial().getAgrupacion(), clave);
            SeguridadDAOFactory.findDAOTitulo(enlaceTransaccional).saveTitulo(tituloK, enlaceTransaccional);
            return tituloK;
        }
        catch (Exception e)
        {
            String error = "<error><msg>No se pudo apropiar la propiedad.</msg><parametros>" + propiedad + "</parametros></error>";
            s_log.error(error);
            s_log.error(e);
            enlaceTransaccional.rollBack();
            throw new ManagerException(error, e, propiedad);
        }
    }

    /**
     * Dice si una {@link Propiedad} ya esta asignada a una {@link Agrupacion}.
     *
     * @param propiedad           buscada.
     * @param enlaceTransaccional para hacer atomica la transaccion.
     *
     * @return <code>true</code> si la Decoracion ya tiene un Titulo asignado; <code>false</code> en caso contrario.
     */
    public Boolean tienePropietario(final Propiedad propiedad, final EnlaceTransaccional enlaceTransaccional) throws ManagerException
    {
        try
        {
            return SeguridadDAOFactory.findDAOTitulo(enlaceTransaccional).existeTituloPropiedad(propiedad, enlaceTransaccional);
        }
        catch (Exception e)
        {
            String error = "<error><msg>No se pudo localizar el Titulo.</msg><parametros>" + propiedad + "</parametros></error>";
            s_log.error(error);
            s_log.error(e);
            enlaceTransaccional.rollBack();
            throw new ManagerException(error, e, propiedad);
        }
    }


}

